*********************************************************************** * ROPES Version 13.0 Fix RMC13010 to base Version 13.0 - 06/26/2007 * * This fix applies to ROPES V13.0. * *********************************************************************** *Installation Instructions * 1. Create the data set to receive the TRANSMITed data set. The * JCL in ALLOC.JCL will do this for you. Upload this job and * tailor it for your installation. Run the job to create the * data set. * 2. Upload the .XMI files to the data sets created in step 1. The * OBJECT.XMI file is uploaded to the &SYSUID.RMC13010.OBJECT.XMI * data set, etc. * 3. Upload the INSTALL.JCL file. Tailor this job for your in- * stallation and run the job to install the modification. *********************************************************************** *RMC13010 - 04/01/2008 - ROPES TCP/IP Support uses the standard trans- * lation routines EZACIC04 and EZACIC05. These * routines use a single translate table that * does not meet all customer needs. * *Problem Summary: * The single "STANDARD" translation tables used by EZACIC04 (E to A) * and EZACIC05 (A to E) do not meet all client needs. IBM has made * available a configurable translation routine EZACICTR with the * entry points EZACIE2A and EZACIA2E which can be configured to use * a named translate table chosen from a list of tables which are * all supported by the translate module. ROPES has been enhanced * to use this new translate table, as well as the older routines. * *Symptoms: * The printer task cannot properly print the ~ (tilde) and µ (carat) * characters using the standard translate table. These characters * are not available in the standard EZACIC04/EZACIC14 translate * tables. The EZACIE2A 'US ' table supports these characters. * *Temporary Fix: * The following new object module must be installed in the * ROPES load library. * ROPECTBL, ROPEKTBL, ROPETRAN, ROPEXLAT * A PPT entry for ROPEXLAT may be needed. If so, specify * LANGUAGE(ASSEMBLER). Autoinstall will also work. * * The following replacement object modules must be installed in the * ROPES load library. * * If you need to use EZACICTR, then you must have previously prepared * the IBM EZACICTR routine in either Single or Multiple mode and the * routine must be available in the SYSLIB concatenation of the link * edit step for these modules. * * In addition, if you plan to use EZACICTR itself (not the E2A or A2E * entry points, then you must also prepare the input and output * translation tables as separate, CICS loadable modules. See, for * example, ROPES source library member RO$T to see what a translate * table must look like. * * The replacement modules are: * ROPELPRP, ROPESOCP, R51LPM0, R51LPM0S, R51LPMUM * * The following replacement source modules must be installed in the * ROPES source library. * R51LPRRC * * The following new source modules must be installed in the * ROPES source library. * LINKCTR, LINKEZAC, RO$TTCTR, RUNTRAN * *Documentation: * A new batch utility program is introduced. The utility allows you * to specify the default translation values for LPR and Direct Sock- * et printing. These defaults will be used to prime the ROLI panel * when adding a new definition, or to provide the translation values * needed when the LPR or Direct Socket printing processes are run * with a printer whos ROLI definition does not contain the settings * introduced with this fix. * * The utility command keyword is * TRANSLATE. It takes as its arguments: * USEFOR - Indicates if the values apply to LPR (LPR) or DIRECT * (Direct Socket printing) * INPROG - Indicates the translation program to use for input. * Valid values are: C05, C15, A2E or CTR. * OUTPROG - Indicates the translation program to use for output. * Valid values are: C04, C14, E2A or CTR. * INTABLE - Specifies the translate table to use for input. * OUTTABLE - Specifies the translate table to use for output. * EZACICTR - Specifies the EZACICTR program mode: S(ingle) or * M(ultiple). * * In order to use the EZACICTR module you must run the LINKCTR job * in the ROPES.SOURCE library to include module EZACICTR and its * entry points EZACIE2A and EZACIA2E. The other four translation * routines will be automatically included from the CICS Sockets * distribution library. * * The printer definition in the ROLI panel now has additional fields * defined to support the translation requirements. * * Line 19: * Translate Output: Specify the translation routine to use when * sending data to the remote end. Choose * C04 - EZACIC04 * C14 - EZACIC14 * E2A - EZACICTR entry point EZACIE2A * CTR - EZACICTR * Translate Input: Specify the translation routine to use when * reading data to the remote end. Choose * C05 - EZACIC05 * C15 - EZACIC15 * A2E - EZACICTR entry point EZACIA2E * CTR - EZACICTR * * Line 20: * Xlate Table Names * Output: The name of the translate table to use for * outgoing data. This is the name of the table * in module EZACIE2A or module EZACICTR. * - For module EZACIE2A this is an internal * table defined in the EZACICTR module. * - For module EZACICTR this is an external * user created translation table which will * be dynamically loaded in CICS at execution * time. * Input: The name of the translate table to use for * incoming data. This is the name of the table * in module EZACIA2E or module EZACICTR. * - For module EZACIA2E this is an internal * table defined in the EZACICTR module. * - For module EZACICTR this is an external * user created translation table which will * be dynamically loaded in CICS at execution * time. * * Line 20: * EZACICTR Mode: Indicates whether EZACICTR was assembled in * Single or Multiple mode. * * EZACICTR is available in the z/OS Communications Server SEZAINST * library for z/OS V1R9.0. * It is also available for earlier releases from IBM at: * http://www-1.ibm.com/support/docview.wss?uid=swg21256665 * in a Technote (FAQ). * * It can also be found by searching for EZACICTR (we used Google). * *Permanent Fix: * This enhancement will be incorporated in the next release of * ROPES. * *End Of Document ***********************************************************************